home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / dmedia / capture.z / capture
Encoding:
Text File  |  2002-10-03  |  11.2 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ccccaaaappppttttuuuurrrreeee((((1111))))                                                          ccccaaaappppttttuuuurrrreeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      capture - record movies, images, or sounds
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccaaaappppttttuuuurrrreeee [----nnnnooooffffoooorrrrkkkk] [----nnnn ####] [----aaaannnnaaaalllloooogggg] [----ddddiiiiggggiiiittttaaaallll] [----vvvviiiinnnnoooo] [----eeeevvvv1111] [----aaaauuuuddddiiiioooo]
  13.      [----vvvviiiiddddeeeeoooo] [----ssssttttiiiillllllll] [----ssssnnnnaaaappppsssshhhhooootttt] [----ffffiiiixxxxeeeeddddMMMMooooddddeeee[audio] [video] [still]
  14.      [snapshot]] [----mmmmoooovvvviiiieeeeCCCCoooommmmpppprrrreeeessssssssiiiioooonnnn none | MVC1 | MVC2 | JPEGhard | JPEGsoft |
  15.      qtvideo ] [----mmmmoooovvvviiiieeeeFFFFoooorrrrmmmmaaaatttt sgi | qt  ] [----eeeexxxxeeeeccccSSSSttttrrrriiiinnnngggg string ] [----ffffiiiixxxxeeeeddddFFFFiiiilllleeee]
  16.      [filename]
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The _c_a_p_t_u_r_e program is obsolete.  The command name and argument syntax
  20.      have been retained for backwards compatibility, but their use is strongly
  21.      deprecated.  _c_a_p_t_u_r_e has been replaced by _m_e_d_i_a_r_e_c_o_r_d_e_r. Please refer to
  22.      the manual page for _m_e_d_i_a_r_e_c_o_r_d_e_r(_1) and update your scripts accordingly.
  23.  
  24.      _c_a_p_t_u_r_e is an interactive program to record digital media files from the
  25.      camera, microphone and workstation screen.
  26.  
  27.      ----nnnnooooffffoooorrrrkkkk
  28.           Causes _c_a_p_t_u_r_e to run in the foreground, rather than the default
  29.           behavior of forking itself off as a background process.
  30.  
  31.      ----nnnn ####
  32.           Chooses the video device # to use on an Indy workstation with an
  33.           Indy Video option board. Vino is device 0; Indy Video is device 1.
  34.  
  35.      ----aaaannnnaaaalllloooogggg
  36.           Use the analog input source for the video camera.
  37.  
  38.      ----ddddiiiiggggiiiittttaaaallll
  39.           Use the digital input source for the video camera.
  40.  
  41.      ----vvvviiiinnnnoooo
  42.           Use the vino video hardware (built in video for the Indy) as the
  43.           input source.
  44.  
  45.      ----eeeevvvv1111 Use the Galileo, Indy Video, or Indigo2 Video hardware has the input
  46.           source.
  47.  
  48.      ----aaaauuuuddddiiiioooo
  49.           Start up in audio capture mode.
  50.  
  51.      ----vvvviiiiddddeeeeoooo
  52.           Start up in video/movie capture mode.
  53.  
  54.      ----ssssttttiiiillllllll
  55.           Start up in video/still frame grab mode.  All images are created in
  56.           SGI rgb file format.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccaaaappppttttuuuurrrreeee((((1111))))                                                          ccccaaaappppttttuuuurrrreeee((((1111))))
  71.  
  72.  
  73.  
  74.      ----ssssnnnnaaaappppsssshhhhooootttt
  75.           Start up in screen snapshot mode.
  76.  
  77.      ----ffffiiiixxxxeeeeddddMMMMooooddddeeee [[[[ aaaauuuuddddiiiioooo vvvviiiiddddeeeeoooo ssssttttiiiillllllll ssssnnnnaaaappppsssshhhhooootttt ]]]]
  78.           Do not allow user to change from startup mode.  This option takes up
  79.           to four optional qualifiers:
  80.  
  81.           aaaauuuuddddiiiioooo
  82.  
  83.           vvvviiiiddddeeeeoooo
  84.  
  85.           ssssttttiiiillllllll
  86.  
  87.           ssssnnnnaaaappppsssshhhhooootttt
  88.  
  89.           _c_a_p_t_u_r_e will limit the choices on the record mode menu to only those
  90.           modes specified.  If ffffiiiixxxxeeeeddddMMMMooooddddeeee is invoked with no qualifiers, it
  91.           locks _c_a_p_t_u_r_e into whatever mode it starts up with and disables the
  92.           record mode menu.
  93.  
  94.      If you use ----aaaauuuuddddiiiioooo,,,, ----vvvviiiiddddeeeeoooo,,,, ----ssssttttiiiillllllll or ----ssssnnnnaaaappppsssshhhhooootttt to force a record mode for
  95.      startup, and you specify a list of qualifiers for ----ffffiiiixxxxeeeeddddMMMMooooddddeeee,,,, you must
  96.      also include the forced startup mode in the list.
  97.  
  98.      ----mmmmoooovvvviiiieeeeCCCCoooommmmpppprrrreeeessssssssiiiioooonnnn
  99.           Chooses compression to use for movie recording.  This option is
  100.           always followed by exactly one qualifier from the following list:
  101.  
  102.           nnnnoooonnnneeee
  103.  
  104.           MMMMVVVVCCCC1111
  105.  
  106.           MMMMVVVVCCCC2222
  107.  
  108.           JJJJPPPPEEEEGGGGhhhhaaaarrrrdddd
  109.  
  110.           JJJJPPPPEEEEGGGGssssoooofffftttt
  111.  
  112.           qqqqttttvvvviiiiddddeeeeoooo
  113.  
  114.           Because the Cosmo Compress option is compatible only with the
  115.           Galileo, Indy Video, and Indigo2 Video options, the JJJJPPPPEEEEGGGGhhhhaaaarrrrdddd option
  116.           cannot be used with the vino video hardware (built in video for the
  117.           Indy).
  118.  
  119.      ----mmmmoooovvvviiiieeeeFFFFoooorrrrmmmmaaaatttt
  120.           Chooses output format for movie recording.  Currently, the available
  121.           choices are the following:
  122.  
  123.           ssssggggiiii
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccaaaappppttttuuuurrrreeee((((1111))))                                                          ccccaaaappppttttuuuurrrreeee((((1111))))
  137.  
  138.  
  139.  
  140.           qqqqtttt
  141.  
  142.  
  143.  
  144.      ----eeeexxxxeeeeccccSSSSttttrrrriiiinnnngggg[_s_t_r_i_n_g]
  145.           specifies a command string for _c_a_p_t_u_r_e to execute whenever it writes
  146.           a file.  If the string "%s" appears within _s_t_r_i_n_g, it will be
  147.           replaced with the file name which was written to disk.  This allows
  148.           an application to learn when a file was written to disk by having
  149.           _c_a_p_t_u_r_e run an accessory program, which sends a message to the
  150.           application.
  151.  
  152.      ----ffffiiiixxxxeeeeddddFFFFiiiilllleeee
  153.           Prevent user from changing the file name set on the command line at
  154.           startup.
  155.  
  156. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  157.      To use _c_a_p_t_u_r_e to record video from your application, into a file called
  158.      TEMPMOVIE which your application will later access, do this:
  159.  
  160.      ccccaaaappppttttuuuurrrreeee ----vvvviiiiddddeeeeoooo ----ffffiiiixxxxeeeeddddMMMMooooddddeeee ----nnnnooooffffoooorrrrkkkk ----ffffiiiixxxxeeeeddddFFFFiiiilllleeee TTTTEEEEMMMMPPPPMMMMOOOOVVVVIIIIEEEE
  161.  
  162.      This will force video mode and will prevent changing from that mode.  It
  163.      will place the resultant movie file in TEMPMOVIE.  The user cannot change
  164.      this name while _c_a_p_t_u_r_e is running.  When _c_a_p_t_u_r_e exits, TEMPMOVIE will
  165.      either contain the last movie created or will be unchanged (if the user
  166.      exited without creating a movie).
  167.  
  168.      To use _c_a_p_t_u_r_e to record either still images or screen snapshots from
  169.      your application into a file called TEMPIMAGE which your application will
  170.      later access, do this:
  171.  
  172.      ccccaaaappppttttuuuurrrreeee ----ssssnnnnaaaappppsssshhhhooootttt ----ffffiiiixxxxeeeeddddMMMMooooddddeeee ssssnnnnaaaappppsssshhhhooootttt ssssttttiiiillllllll ----nnnnooooffffoooorrrrkkkk ----ffffiiiixxxxeeeeddddFFFFiiiilllleeee TTTTEEEEMMMMPPPPIIIIMMMMAAAAGGGGEEEE
  173.  
  174.      This will force screen snapshot mode and will allow the user to choose
  175.      between screen snapshot mode and video still frame mode.  It will place
  176.      the resultant image file in TEMPIMAGE.  The user cannot change this name
  177.      while _c_a_p_t_u_r_e is running.  When _c_a_p_t_u_r_e exits, TEMPIMAGE will either
  178.      contain the image file created or will be unchanged (if the user exited
  179.      without creating a movie).
  180.  
  181.      To use _c_a_p_t_u_r_e to record SGI format movies from the IndyCam using MVC2
  182.      video compression do this:
  183.  
  184.      ccccaaaappppttttuuuurrrreeee ----vvvviiiiddddeeeeoooo ----ddddiiiiggggiiiittttaaaallll ----vvvviiiinnnnoooo ----mmmmoooovvvviiiieeeeFFFFoooorrrrmmmmaaaatttt ssssggggiiii ----mmmmoooovvvviiiieeeeCCCCoooommmmpppprrrreeeessssssssiiiioooonnnn MMMMVVVVCCCC2222
  185.  
  186.      This will start up _c_a_p_t_u_r_e in video capture mode, using the IndyCam and
  187.      the built-in Indy video hardware.  The resulting movie will be saved in
  188.      SGI movie format using MVC2 video compression.  The user may change both
  189.      the recording mode (video, still, audio, snapshot) and the movie file
  190.      name using _c_a_p_t_u_r_e'_s graphical interface.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ccccaaaappppttttuuuurrrreeee((((1111))))                                                          ccccaaaappppttttuuuurrrreeee((((1111))))
  203.  
  204.  
  205.  
  206.      To use _c_a_p_t_u_r_e to record a movie file, then to run the program "myprog"
  207.      whenever it writes a file, do this:
  208.  
  209.      ccccaaaappppttttuuuurrrreeee ----vvvviiiiddddeeeeoooo ----eeeexxxxeeeeccccSSSSttttrrrriiiinnnngggg "myprog %s"
  210.  
  211.      This will start up _c_a_p_t_u_r_e in video capture mode, using the current
  212.      default settings.  Every time the user captures a file, capture will
  213.      execute the program "myprog", passing it the name of the file the user
  214.      just captured.
  215.  
  216. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  217.      mediarecorder(1)
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.